home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / RTOOL112.ZIP / R_TOOLS.DOC < prev    next >
Text File  |  1993-09-17  |  16KB  |  323 lines
  1.  
  2.  
  3.                   ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄▄▄▄  ▄▄▄ ▄▄▄  ▄▄▄ ▄▄▄▄▄▄▄
  4.                   █ ▄▄▄ █ █ █ █ █ █ ▄▄ ▀█ █▄▀█▀▄█ █▀▄█ █ ▄▄▄▄█
  5.                   █ ▄ ▄▄█ █ █▄█ █ █ █▄▀ █  ▀█ █▀  ▀▀▀  █▄▄▄▄ █
  6.                   █▄█▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄█▀   █▄█        █▄▄▄▄▄█
  7.                     ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄     ▄▄▄▄▄▄▄
  8.                     █▄▄ ▄▄█ █ ▄▄▄ █ █ ▄▄▄ █ █ █     █ ▄▄▄▄█
  9.                       █ █   █ █▄█ █ █ █▄█ █ █ █▄▄▄▄ █▄▄▄▄ █
  10.                       █▄█   █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█
  11.  
  12.                          Release 1.12 - September 1993
  13.  
  14.                        1993 (C) Chief Data Recovery Ltd.
  15.  
  16.                               All Rights Reserved.
  17.  
  18.  
  19.     ┌──────────────────────────────────────────────────────────────────────╖
  20.     │ INTRODUCTION                                                         ║
  21.     ╘══════════════════════════════════════════════════════════════════════╝
  22.     During my operation of  Rudy's Place BBS I wrote lots of small utilities
  23.     to help me maintain  the BBS.  As  I needed  these tools,  I imagin that
  24.     there are other Sysops  that will  find some of these utilities suitable
  25.     for their needs, so I decided to distribute them to the free world.
  26.  
  27.  
  28.     ┌──────────────────────────────────────────────────────────────────────╖
  29.     │ TOOLS DESCRIPTION                                                    ║
  30.     ╘══════════════════════════════════════════════════════════════════════╝
  31.     The package include  several utilities,  each  is a  stand alone utility
  32.     which have nothing to do with other programs in the package. Each of the
  33.     programs is described  differently,  as if it was distributed seperatly.
  34.     Tools that handles  the users files must be run from the same disrectory
  35.     where USERSxxx.BBS files are found.  Please note that  all  RA  specific
  36.     utilities are compatible with RA 2.00 only.   They should not be used on
  37.     RA 1.11 or earlier versions.
  38.  
  39.  
  40.     ┌──────────────────────────────────────────────────────────────────────╖
  41.     │ DIZ.EXE                                                              ║
  42.     ╘══════════════════════════════════════════════════════════════════════╝
  43.     This little  program  strip  FILE_ID.DIZ  form  ZIP,  ARJ  and LZH  into
  44.     FILES.BBS.  It will not check for the existent of the file in FILES.BBS.
  45.  
  46.                             USAGE: DIZ filemask.ext
  47.  
  48.     DIZ requires that PKUNZIP.EXE,  ARJ.EXE and LHA.EXE will be somewhere in
  49.     the DOS Path for each archive type.  Note that  DIZ  does not check if a
  50.     file description is already exist in FILES.BBS.
  51.  
  52.  
  53.     ┌──────────────────────────────────────────────────────────────────────╖
  54.     │ ZID.EXE                                                              ║
  55.     ╘══════════════════════════════════════════════════════════════════════╝
  56.     ZipID is used  to  identify ZIP  version that  ZIP archives  were packed
  57.     with.
  58.  
  59.                         USAGE: ZID filemask.ext [/1|/2]
  60.  
  61.     It will list all files with their version of ZIP.  If /1 or /2 are used,
  62.     ZID will display only files that were created with ZIP 1.xx or 2.xx.
  63.  
  64.  
  65.     ┌──────────────────────────────────────────────────────────────────────╖
  66.     │ WIPE.EXE                                                             ║
  67.     ╘══════════════════════════════════════════════════════════════════════╝
  68.     Sometimes,  when USERON.BBS  is messed up from any reason,  this program
  69.     can clear the USERON.BBS file and create an empty one.
  70.  
  71.                                  USAGE: WIPE n
  72.  
  73.     It will create an  empty USERON.BBS file for 'n' nodes.  Compatible with
  74.     RA 2.00. Do not use in RA 1.xx.
  75.  
  76.  
  77.     ┌──────────────────────────────────────────────────────────────────────╖
  78.     │ NODEFIND.EXE                                                         ║
  79.     ╘══════════════════════════════════════════════════════════════════════╝
  80.     This utility will search the nodelist for a specific node address.
  81.  
  82.               USAGE: NODEFIND [d:\path\]nodelist.xxx zone:net:node
  83.  
  84.     where nodelist.xxx  is   the  name  of  the  nodelist  file,   including
  85.     extension, and the zone:net:node is the complete node number address. No
  86.     wildcards are allowed in both nodelist name and node address.
  87.  
  88.  
  89.     ┌──────────────────────────────────────────────────────────────────────╖
  90.     │ BUILDIDX.EXE                                                         ║
  91.     ╘══════════════════════════════════════════════════════════════════════╝
  92.     It happends to  me,  sometimes,  that the USERSIDX.BBS is trushed and so
  93.     when users are logging in, RA recognizes them as new users. BUILDIDX.EXE
  94.     will rebuild RA 2.00 USERSIDX.BBS file from scratch.
  95.  
  96.                                 USAGE: BUILDIDX
  97.  
  98.     The program  should  run  in  the same  directory where  your USERS*.BBS
  99.     resides and the RA should not run during BUILDIDX's execution.
  100.  
  101.  
  102.     ┌──────────────────────────────────────────────────────────────────────╖
  103.     │ BUILDXI.EXE                                                          ║
  104.     ╘══════════════════════════════════════════════════════════════════════╝
  105.     The USERSXI.BBS file in RA 2.00 does not hold any data,  and sometime it
  106.     may trash for several reasons. BUILDXI will rebuild an empty USERSXI.BBS
  107.     file according to the number of users in USERS.BBS.
  108.  
  109.                                  USAGE: BUILDXI
  110.  
  111.     The program  should  run  in  the same  directory where  your USERS*.BBS
  112.     resides and the RA should not run during BUILDIDX's execution.
  113.  
  114.  
  115.     ┌──────────────────────────────────────────────────────────────────────╖
  116.     │ FIXALIAS.EXE                                                         ║
  117.     ╘══════════════════════════════════════════════════════════════════════╝
  118.     There are users in  the user  file that  their alias (handle) is not set
  119.     and when entering a  program which  uses aliases  (like ChatManager with
  120.     Handles set to ON), there is no name listed in the user's list. FIXALIAS
  121.     will fill these empty  fields with  the user's  name if the alias is not
  122.     available.
  123.  
  124.                                 USAGE: FIXALIAS
  125.  
  126.     The program  should  run  in  the same  directory where  your USERS*.BBS
  127.     resides and the RA should not run during BUILDIDX's execution.
  128.  
  129.  
  130.     ┌──────────────────────────────────────────────────────────────────────╖
  131.     │ USERSDUP.EXE                                                         ║
  132.     ╘══════════════════════════════════════════════════════════════════════╝
  133.     UsersDUP will search  your USERS.BBS  for duplicate  user entries.  If a
  134.     user record is  found more then once,  it will be reported to the screen
  135.     along with the record numbers of the records.
  136.  
  137.                                 USAGE: USERSDUP
  138.  
  139.     UsersDUP may run while RA is up and running.  It will not write anything
  140.     to the users file.
  141.  
  142.  
  143.     ┌──────────────────────────────────────────────────────────────────────╖
  144.     │ TRUNC.EXE                                                            ║
  145.     ╘══════════════════════════════════════════════════════════════════════╝
  146.     TRUNC is a utility  to truncate  files to  a spesific  size.  It may  be
  147.     useful when fixing damaged files or experamenting with disk space. TRUNC
  148.     works in both ways  ; It can  truncate files to a size smaller or bigger
  149.     the file's original size.
  150.  
  151.                          USAGE: TRUNC filename.ext size
  152.  
  153.     'filename.ext' may  be  any DOS  filename in  the current  directory and
  154.     'size' is the size you want to truncate the file to.
  155.  
  156.  
  157.     ┌──────────────────────────────────────────────────────────────────────╖
  158.     │ UCHECK.EXE                                                           ║
  159.     ╘══════════════════════════════════════════════════════════════════════╝
  160.     UCHECK is a utility  to check and validate the users files.  UCHECK will
  161.     check if the  size  of  the  users files  match,  validate the  USERSIDX
  162.     information,  check  for  deleted  users  and will  check for  duplicate
  163.     handles and will fix them.
  164.  
  165.                                  USAGE: UCHECK
  166.  
  167.     UCHECK will  recommend  actions  if  errors found.  UCHECK  also provide
  168.     errorlevels for  batch processing.  It  will exit  with errorlevel  0 if
  169.     everything checks  OK,  errorlevel 1 if  users files can not be found or
  170.     opened and errorlevel 2 if a sysop actions is needed.
  171.  
  172.  
  173.     ┌──────────────────────────────────────────────────────────────────────╖
  174.     │ FDPW.EXE                                                             ║
  175.     ╘══════════════════════════════════════════════════════════════════════╝
  176.     FDPW is a utility to syncronize session passwords with your pollers.  It
  177.     reads the FrontDoor  log  file  and  searches for  "Unexpected password"
  178.     error messages and adds the missing passwords to the PASSWORD.FD file in
  179.     the FrontDoor directory.  The  FD= environment variable  must be set and
  180.     point to the FrontDoor directory before FDPW can run.
  181.  
  182.                                USAGE: FDPW fd.log
  183.  
  184.     You must specify the FrontDoor log filename in the command line.
  185.     FDPW runs on FrontDoor 2.02 or higher.
  186.  
  187.  
  188.     ┌──────────────────────────────────────────────────────────────────────╖
  189.     │ RENUM.EXE                                                            ║
  190.     ╘══════════════════════════════════════════════════════════════════════╝
  191.     RENUM is a utility to rename files according to sequential numbers, just
  192.     like FrontDoor's Editro (FM) renames files in the NetMail directory.
  193.  
  194.                       USAGE: RENUM filemask.ext [newext]
  195.  
  196.     RENUM must run  in the same directory where the files to be renames are.
  197.     the [newext] parameter is optional and will be used as the new extension
  198.     for the renumbed files. Default extension is [NUM].
  199.  
  200.     For example,  running 'RENUM  *.LIS BBS' will  rename all files with the
  201.     extension of [LIS] to  sequential files with the extension of [BBS] (ie.
  202.     1.BBS, 2.BBS, 3.BBS etc.).
  203.  
  204.     Because the operation  of RENUM is non-reversable,  RENUM will create an
  205.     UNDO batch file  named REN_UNDO.BAT.  If you wish to rename the files to
  206.     their original names, just run this batchfile.
  207.  
  208.  
  209.     ┌──────────────────────────────────────────────────────────────────────╖
  210.     │ GUB_SET.EXE                                                          ║
  211.     ╘══════════════════════════════════════════════════════════════════════╝
  212.     GUB_SET is a  Global USERS.BBS Set utility.  It allows global changes to
  213.     be applied to FILES.BBS.
  214.  
  215.                USAGE: GUB_SET field1=value1 [field2=value2] ...
  216.  
  217.     The fields that may be changed and their valid values are as follows:
  218.  
  219.     Field      Meaning                         Values
  220.     ────────── ──────────────────────────────── ───────────────
  221.     ANSI=      Toggle ANSI                      ON or OFF
  222.     AVATAR=    Toggle AVATAR                    ON or OFF
  223.     BILL=      Toggle post bill                 ON or OFF
  224.     CLS=       Toggle Clear Screen              ON or OFF
  225.     CREDIT=    Set NetMail Credit               0 to 2147483647
  226.     DELETE=    (un)Delete all users             ON or OFF
  227.     FLAGxy=    Toggle user flags (xy = A1-D8)   ON or OFF
  228.     GROUP=     Set group                        0 to 65535
  229.     GUEST      Toggle Guest flag                ON or OFF
  230.     HIDDEN=    Toggle Hidden flag               ON or OFF
  231.     HOTKEY=    Toggle hotkeys                   ON or OFF
  232.     LANG=      Set Language                     0 to 255
  233.     MAILSCAN=  Toggle EchoMail mailbox scan     ON or OFF
  234.     MORE=      Toggle More prompt               ON or OFF
  235.     MSGED=     Toggle FullScreen Msg Editor     ON or OFF
  236.     MSGVU=     Toggle FullScreen Msg Viewer     ON or OFF
  237.     NOKILL=    Toggle NoKill flag               ON or OFF
  238.     PAGE=      Toggle Page priority             ON or OFF
  239.     PROTOCOL=  Set default protocol             AlphaBetic
  240.     PWDCHNGE=  Set Last password change         0 to 255
  241.     QUIET=     Set Quiet mode                   ON to OFF
  242.     SEC=       Set security level               0 to 65535
  243.     XFER=      Toggle XFER priority             ON to OFF
  244.  
  245.     Up to 10 fields to change may be specified in one command.
  246.  
  247.     Each field should be followed by the '=' sign,  followed by a value with
  248.     no spaces between them. Different fields should be seperated by a space.
  249.     The command line  parameters are NOT case sensitive and may apear in any
  250.     order. Please not  that there  is not  validation for different field in
  251.     the command line,  ie.  if you specify ANSI=OFF and MSGED=ON - it's your
  252.     problem.
  253.  
  254.     For example,  running 'GUB_SET  SEC=0' will lockout  all users.  running
  255.     'GUB_SET FlagA1=ON Credit=10' will  set flag A1 and change the credit to
  256.     a value of 10 for all users.
  257.  
  258.  
  259.     ┌──────────────────────────────────────────────────────────────────────╖
  260.     │ RAREPORT.EXE                                                         ║
  261.     ╘══════════════════════════════════════════════════════════════════════╝
  262.     RAReport is a  utility to  create readable text reports of file and mail
  263.     areas and groups.  It reads  your FILES.RA  and MESSAGES.RA (with F or M
  264.     Group files) and create  a sorted list of all areas.  In each report,  a
  265.     Group 0 is created to list areas that are not groupd.
  266.  
  267.                       USAGE: RAREPORT /F|/M [/G] [OutFile]
  268.  
  269.     You must specify either  /F or  /M to  create Files or Messages reports.
  270.     The /G tells RAReport to list group names only.  An optional output file
  271.     may be specified in  the command line.  If not specified,  RAReport will
  272.     default to RAREPORT.LST in the current directory.
  273.  
  274.     for example: 'RAREPORT /F  FILES.LST' will create full file area list in
  275.     FILES.LST in the current directory. 'RAREPORT /M /G' will create list of
  276.     message groups in RAREPORT.LST in the current directory.
  277.  
  278.  
  279.     ┌──────────────────────────────────────────────────────────────────────╖
  280.     │ WARRANTY                                                             ║
  281.     ╘══════════════════════════════════════════════════════════════════════╝
  282.     None, Whatsoever.  These programs  are used daily on Rudy's Place BBS so
  283.     they should work for you too.
  284.  
  285.  
  286.     ┌──────────────────────────────────────────────────────────────────────╖
  287.     │ HISTORY                                                              ║
  288.     ╘══════════════════════════════════════════════════════════════════════╝
  289.     Release 1.00 - First public release.
  290.     Release 1.01 - Fixed nasty bug in NODEFIND program.
  291.                    Fixed ZID to support full path.
  292.     Release 1.02 - Added FIXALIAS and BUILDXI utilities.
  293.     Release 1.03 - Improved speed of BUILDIDX in about 300%.
  294.     Release 1.04 - NODEFIND  fixed  to run  even if  FrontDoor is  using the
  295.                    Nodelist.
  296.     Release 1.05 - Added USERSDUP utility.
  297.     Release 1.06 - Added TRUNC utility.
  298.     Release 1.07 - Added UCHECK utility.
  299.     Release 1.08 - Added FDPW utility.
  300.     Release 1.09 - Fixed spelling mistakes in UCHECK.
  301.                    FDPW can now run even if FrontDoor is running.
  302.     Release 1.10 - Added RENUM utility.
  303.     Release 1.11 - Added GUB_SET utility.
  304.     Release 1.12 - Changes in UCHECK.EXE.
  305.                    Added RAREPORT.EXE.
  306.  
  307.  
  308.     ┌──────────────────────────────────────────────────────────────────────╖
  309.     │ COMMENTS                                                             ║
  310.     ╘══════════════════════════════════════════════════════════════════════╝
  311.     Cemments may be  sent to Nemrod Kedem in one of the following addresses:
  312.  
  313.                            FidoNet          2:403/138
  314.                            VirNet             9:972/0
  315.                            BetaNet         144:1442/2
  316.                            FD_Net          255:3972/0
  317.                            Compuserve       100274,73
  318.                            Fax         +972-8-403-295
  319.                            BBS        +972-3-966-7562
  320.  
  321.  
  322.                                    -= EOF =-
  323.